home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Utilities Experience
/
The Utilities Experience - Volume 1.iso
/
software
/
workbench+shell
/
g-p
/
mcp
/
docs
/
aguideconv.doc
< prev
next >
Wrap
Text File
|
1995-07-22
|
3KB
|
118 lines
AGuideConv V1.0 copyright 1994 by
=============== Michael Friedrich
All Rights Reserved.
Converts OS3.x-AmigaGuide-Texts to OS2.x-AmigaGuide-Texts
Copyright
=========
This software is copyright 1994 by Michael Friedrich. All Rights Reserved.
Is is PUBLIC DOMAIN, so you may use this piece of software freely.
This software may be freely distributed as long as no more than a nominal
fee is charged to cover time and copying costs.
Commercial usage is only allowed with the written permission of the author.
Disclaimer: The author makes no warranties, either expressed or implied.
This program is provided on an "as is" basis and the author will not be
liable for any damages caused or alleged to be caused directly or indirectly
by using or not using this program. Use at your own risk.
Introduction
============
For all those OS2.x-users:
Starting with OS3.0 the AmigaGuide-Format has been enhanced.
Besides other new features the keyword @WORDWRAP was introduced
allowing the texts to adapt to the user's window-width.
AmigaGuide-Texts using this keyword can't be opened with AmigaGuide-
Viewers from OS2.x.
AGuideConv removes this keyword and reformats the text to a fixed
text-width. This way OS2.x-users should be able to read (some of)
the OS3-AmigaGuide-Texts.
Annotation: 'AGuideConv' has been written to convert the AmigaGuide-Help
from TurboCalc. I then decided to release it freely, perhaps you can
use it for any other text, too. Please excuse some limitations that might
arise from this fact, but first of all AGuideConv was designed to work
correctly with TurboCalc.guide - and I'm really lazy ;^)
(See Limitations below.)
Usage
=====
AGuideConv can be started either from workbench or from shell.
WorkBench-Usage
---------------
Select the AmigaGuide-Text-Icon(s) then shift-double-click on the
AGuideConv-Icon. (i.e. press down the shift-key and double-click on the
icon).
For every text a requester with the filename appears. This is
your last chance to abort the conversion. If you select 'OK'
the text will be modified. (If you own OS1.2/1.3 no messages will
be shown but the conversion with start immediately.)
CLI-Usage
---------
AGuideConv textname
Start AGuideConv with the parameter 'textname' being the AmigaGuide-Text.
Example:
AGuideConv dh0:TurboCalc/TurboCalc.guide
Attention:
----------
AGuideConv replaces the texts by their converted versions, i.e. the
old version will be lost!!!
If AGuideConv fails, the texts will be lost. Thus it is recommended to
duplicate the text before starting AGuideConv, i.e.: never ever convert
a unique original version!
What is done:
-------------
* @WORDWRAP, @INDEX and @FONT commands are removed
* text will be wordwrapped to a fixed width of 77
* style-commands (@{b}, @{ub}, @{i}, @{ui}, @{u} and @{uu}) are removed,
this is not absolutly necessary, but it should look better afterwards.
Limitations: (see note above)
-----------------------------
* used textwidth cannot be changed
* Reads the complete text to memory before converting
* Saves the converted version to the same file!
The Auther
==========
This program was written by
Michael Friedrich
Mühlenstr.25
77694 Kehl
Germany
EMail:
------
s_friedr@ira.uka.de
ukrc@rz.uni-karlsruhe.de
If you have any problems, suggestions or bug reports (oh no :)
feel free to send an EMail.